home *** CD-ROM | disk | FTP | other *** search
/ MacFormat España 13 / MacFormat n. 13 (Spain) / Macformat 13.bin / Shareware Internet / Comms / DogXRay folder / Dog X-Ray / DogXRay Readme next >
Encoding:
Text File  |  1996-01-07  |  11.9 KB  |  274 lines
  1.  
  2. Dog X-Ray 1.0d1                        January 5th 1995
  3.  
  4.  
  5. To whom it may concern:
  6.  
  7. What is this?
  8. This is the first “working” prototype of Dog Xray.  It is a TNC interface
  9. package designed for the PK232-MBX and the PowerMac.  Specifically, I
  10. wrote it because I couldn’t get MacRatt to work on the PowerMac 8500.
  11.  
  12. THIS VERSION ONLY WORKS ON A PPC.  IT IS NOT A FAT BINARY.
  13.  
  14. The purpose of DogXRay is to aid Dxers in their usage of the DX cluster
  15. network.  Consequently, DXRay is not a “generic” TNC tool.  As it evolves
  16. (if it evolves) I’ll add features related to DX logging, announcing,
  17. predicting MUF, predicting band openings, calculating beam angles, etc...
  18.  
  19. At the moment Dog X-Ray has a number of significant limitations.  These
  20. are due primarily to the fact I simply haven’t gotten around to making the
  21. user interface pretty, I’ve been working mainly on trying to make the
  22. PowerPlant code behave the way I think it should.  Look at this as a test
  23. version, expect little, and you’ll get it.
  24.  
  25. Limitations:
  26.         
  27.       -     Only tested with the PK-232MBX (circa 1990) and the 8500/120
  28.     because that’s what I have.
  29.  
  30.       - The buffer sizes in the scrolling windows are only 100 lines. 
  31.     I wanted to save memory.  This can be changed, but as I have no
  32.      “Preferences” dialog/save feature written yet, I have to change
  33.     a compiler variable to do it.
  34.  
  35.       - Command completion only works for those commands listed in the
  36.     AEA PK232 user’s manual.  If there are others, you’ll have to 
  37.     enter them yourself.
  38.  
  39.       - Corillary to the above: ONLY those commands for which command
  40.     completion works will be sent to the TNC.
  41.  
  42.       - ONLY Packet mode is supported.
  43.  
  44.       - There are no “Preferences. . .” implemented yet, so everything
  45.          related to buffer sizes, file names, etc...is hardwired at this point.
  46.      Sorry, but this is the d1 version, after all.
  47.  
  48. What you need to make it work:
  49.  
  50. 1) DogXRay uses the Communications Toolbox to facilitate
  51. communications to the TNC.  You need to have the standard Apple “Serial
  52. Tool” installed on your system.  As I don’t think it would be legal for me
  53. to do so, I have not included a copy of this with DogXRay.  However, the
  54. CTB serial tool is available on any of the INFOMAC reflectors for
  55. anonymous FTP, or from ftp:info.apple.com, or on eWorld, or any other of
  56. the commercial services.  The version I use is v1.0.2 and is dated 1992, so
  57. this isn’t new stuff.  You don’t need any other of the CTB tools. Don’t
  58. bother installing them.
  59.  
  60.  
  61. 2)DogXRay looks for a file in its folder called 
  62.     “DX232 Commands.TEXT”.  If you don’t have this file in the folder
  63. DogXRay is run from, it will complain and probably crash. (I haven’t
  64. implemented.  The “graceful” exit isn’t there.  Sorry again.  You will also
  65. need a file called DX232Phonetics.TEXT if you want the the spotting
  66. announcer to work.
  67.  
  68. The DX232 Commands.TEXT file is a simple text file that contains data in
  69. the following format:
  70. “PK232 Command Name<TAB>2-letter acronym<CR>” 
  71. This related the PK232 commands to their host mode acronyms.  I made it
  72. a text file so it could be easily modified by the user (me).  If you add
  73. commands, keep in mind you MUST insert them in ALPHABETICAL order by
  74. command.  If you don’t insert them in alphabetical order, command
  75. completion won’t work right.
  76.  
  77. How to make it work:
  78.  
  79. 1) With your TNC connected and turned on, start DogXRay.  Two windows
  80. appear.  The first is a floater called PK232 Command Window.  The second
  81. is called “Monitor”.  The “Monitor” is what it says, and stays that way no
  82. matter which mode you’re in.
  83.  
  84. 2) DogXRay comes up in “Dumb Terminal” mode.  That is, anything you type
  85. in the command window goes out to the TNC as reflected in the Monitor. 
  86. You can use the program in this mode if you like.  It’s not very satisfying,
  87. though.  You can do your standard TNC setup things in this mode, though.
  88.  
  89. 3) If you need to set the CTB serial tool configuration: - make sure you
  90. have the Command window selected (or the menu won’t be active).  In the
  91. “Settings” menu, select “Connection...” and use the CTB to get your port
  92. and speed settings right.  I use 9600 baud, 8 data bits, one stop bits, no
  93. handshake (though, you probably SHOULD use DTS/RTS hardware
  94. handshaking, but I never bother with a connection as slow as 9600).  Make
  95. sure your TNC is set this way too. . . of course.   
  96.  
  97. Make certain HPOLL is OFF.  That is, type “HP N” in the command window
  98. to shut off polling mode.
  99.  
  100. With polling mode ON, Dog X-Ray will have to poll for every packet it
  101. wants to grab from the TNC.  I don’t have that handshake enabled for
  102. anything other than the send/acknowledgment of a TNC command right
  103. now.  So, if you leave HP ON, nothing other than command responses (or
  104. buffered packets that will mistakenly come across to the program who
  105. will think (mistakenly) that they are command responses) will come from
  106. the TNC.
  107.  
  108.  
  109. 4) Presuming you’ve got the software talking to the TNC, go into host
  110. mode by: a) selecting the command window and b) selecting “Host Mode
  111. on” in the “Settings” menu.   Note: I probably should check for Host mode
  112. on startup, but I don’t (yet).
  113.  
  114. If the TNC is ALREADY is Host mode, the program will recognize this.  If
  115. it’s already connected to something, it will open a connection window for
  116. each connection.  Otherwise, very little will happen visibly.  Again, make
  117. certain HP is NO or HP is OFF.   MacRatt required polling to be on.  I can see
  118. how this would be necessary if the TNC was firing data across faster than
  119. the Mac could handle it.  But with today’s faster Macs, it’s completely
  120. unnecessary for anything other than making sure you don’t try to shove
  121. data down the TNC’s throat faster than it can swallow.  Consequently, all
  122. commands sent from the Mac to the TNC are sent with the Poll/Ack
  123. handshake.
  124.  
  125. 5) If you’re in host mode, the first thing you’ll notice is that command
  126. completion works in the commands floating window.  From now on, you’ll
  127. use this window only to speak to issue commands to the TNC, and not to
  128. send data out your connection.  
  129.  
  130. Command completion works like this: type any part of a PK232 command
  131. and hit ESC.  The command nearest (alphabetically) to what you’ve typed
  132. will appear in the window.  
  133.  
  134.     So, type:   MH <ESC>
  135. and :MHEARD will appear in the window.  You can hit return now and the
  136. command will issue.
  137.  
  138. You can also type: “mhe” or any part of the command, upper or lower case.
  139.  
  140. You can type   “aw 8” if you want to set AWLEN to 8.  The command will
  141. automatically be completed for you.  In fact, all commands are completed
  142. whether you want them to be or not, so be careful what you type in that
  143. window.  
  144.  
  145. For instance: if you type   “CO K6LLK”, thinking you’ll connect to K6LLK
  146. you won’t get what you think.  “CO” maps to “Connect” in terminal
  147. emulation mode, but in Host mode, “CO” completes to “CODE”, not Connect. 
  148. “CON” completes to CONMODE.  To get connect, you have to type “CONN”.  If
  149. you ever have any doubt what command you’re issuing, hit <ESC> after
  150. typing the command word (before you type your arguments)  and you’ll see
  151. what it completes to.
  152.  
  153. Watch the monitor window to see what’s happening to your commands. 
  154. I’ve left the debug switches all turned on, so you can see the host mode
  155. binary reply with an ASCII interpretation (this is for me,and not intended
  156. to be a user feature, but if it helps, I’ll leave it). 
  157.  
  158. 6) HOW TO CONNECT:
  159.  
  160. To issue a connect command you have to type something like this in the
  161. command window:
  162.  
  163. CONNECT /channel# stationName.
  164.  
  165. For example:
  166.  
  167. CONN /0 K6LLK <CR>
  168.  
  169. connects you to station K6LLK on Channel 0 of the PK232.
  170.  
  171. CONNECT /4 W6OAT
  172.  
  173. connects you to W6OAT on channel 4 of the TNC.
  174.  
  175. By the way, it doesn’t matter which TNC channel you pick to connect on,
  176. just don’t try to connect to more than one station per channel.
  177.  
  178.  
  179. 7) Once you’ve issued the connect command, a window will appear with
  180. something like   “K6LLK : 0” as the title, confirming you’ve connected to
  181. K6LLK on channel 0.    You can talk to K6LLK by clicking in the command
  182. window’s text entry box at the bottom.  Type whatever you want.  When
  183. you’re done with the connection and you sign with the connected station,
  184. you can dismiss the connection window by clicking the close box or
  185. choosing CLOSE CHAN 0, from the FILE menu.  (For some reason, the
  186. connection window has to be selected for the CLOSE menu to work.  This is
  187. a problem with the way I’ve set up the commanders in PowerPlant and I
  188. haven’t figured out how to make it more generic. . .) Note: windows don’t
  189. automatically disappear when a connection terminates the way they
  190. automatically appear when a connection initiates.   Is this a problem?  
  191. I was trying to separate the TNC connection window from the logical
  192. station connection itself, allowing you to open a generic channel 0, say,
  193. then connecting it to whatever you want.
  194.  
  195. 8) You can open more connection windows at any time by selecting NEW
  196. CHAN X (insert a number between 0-9 for ‘X’) from the FILE menu.  These
  197. windows will not be connected to anything until you issue a “CONNECT
  198. /chan stationName” command to the TNC in the command window.
  199.  
  200. Note: if you open a window this way, it’s title doesn’t currently update
  201. automatically to the station name until you issue a connection status
  202. command in the command window.  To issue a connection status command
  203. type   “CONN” with no arguments in the connection window.  The name will
  204. update.  This has to be fixed later.
  205.  
  206. 9) About the talking stuff:
  207.     if you have MacinTalk installed, Dog X-Ray can verbally report the DX
  208. spots it hears.  It does this by recognizing the characters “DX” in the first
  209. and second position of any string that comes in (so at the moment, it’s
  210. pretty stupid and will incorrectly assume ANYTHING that comes over the
  211. TNC that starts with “DX” is a spotting announcement.  This has to be
  212. smarttened up.
  213.  
  214. The messages are currently reported in the same mode as the fabled
  215. “Charlie” on the DX cluster repeaters.  That is for something like
  216.  
  217. DX de AA6YD:   14001.3   5A0ABC      0200Z
  218.  
  219. Dxr will say: “DX alert, five-alpha-zero-alpha-baker-charlie, fourteen-
  220. zero-zero-one-point.three.”
  221.  
  222. You can disable this potentially annoying feature by shutting it off in the
  223. “Settings” menu.  If you don’t have Macintalk installed, nothing will
  224. happen.
  225.  
  226.  
  227. 10) The DX Window
  228. This isn’t very helpful just yet.  It keeps a scrolling record of all the DX
  229. spots it hears in terms of Station, Frequency, Timestamp, and any notes
  230. the spotter included.  Later, this database will form the basis of the
  231. logger which will alert the user to potential “new ones” per band and
  232. mode.  Right now, it isn’t much of anything.  The Macintalk voice will NOT
  233. work unless this window is up on the screen.  You get this window by
  234. making sure the terminal entry window in the connection window is
  235. selected (as evidenced by the blinking caret), then select command-5 or
  236. “Open DX Window”.  The window appears, looking much like the monitor
  237. window.
  238.  
  239. 11) Debug stuff
  240. Send Poll sends a PK232 host mode polling packet to the TNC.  
  241.  
  242.  
  243.  
  244. What Next?
  245.  
  246. The menus all have items that are never enabled.  There is much to do
  247. interface-wise.  I’m sending this out to a few people to get some feedback
  248. on whether the communications section of the program works or not. 
  249. There’s no sense building advanced features if the simple terminal and
  250. host mode interfaces don’t work.
  251.  
  252. Known problems. . .   
  253.  
  254. There are many.  I’m having a problem with the scrolling window updates. 
  255. I’m using the PowerPlant active scrollers, and if you try to manually
  256. scroll while the window is scrolling under the influence of the data
  257. stream, you’ll get junk in the window.  This really isn’t there, of course,
  258. and if you force a redraw by covering the window and uncovering it, or
  259. scrolling back and forth (when the data stream stops), all will be well.  I
  260. haven’t figured out how to deal with this yet (stop the data input stream
  261. when the user is scrolling?  Don’t let the user scroll when the data is
  262. coming in?  Ideas are welcome.)
  263.  
  264.  
  265. My THANKS!
  266.  
  267. Thanks a lot for trying this out for me.  Please send any bug reports,
  268. comments, ideas for how the interface should look, etc, to me at:
  269.  
  270. joe@killerowls.com.
  271.  
  272.  
  273.  
  274. Thanks again for your time looking at this program.